In diesem Artikel lernen Sie eine neue Möglichkeit kennen, Daten von einem Formular an eine Remote-URL zu übergeben – Webhook. Mithilfe eines Webhook können Sie Informationen mit Ressourcen von Drittanbietern austauschen. Rufen Sie beispielsweise Ihre individuelle URL auf oder senden Sie Formulardaten an diese Adresse.

Mit Webhooks können Sie Workflows zwischen Systemen/Diensten/Anwendungen (einschließlich Aufrufen zwischen verschiedenen Projekten innerhalb eines QuintaDB-Systems) integrieren. Dies ist eine große Hilfe bei der Organisation Ihrer Geschäftsprozesse und wir sind sicher, dass Sie viele Möglichkeiten finden werden, die Vorteile von Webhooks zu nutzen.

Inhalt:

• Anwenden von Webhooks über das Feld „Aktion“.
  • Erstellen Sie eine Aufgabe
  • Webhook-Einstellungen
  • Header anfordern
  • Parameter anfordern
• Anwenden von Webhooks über "Bedingte Aktionen".

Hinweis: Webhooks dienen in erster Linie der Kommunikation mit externen Diensten. Innerhalb des QuintaDB-Systems reicht es aus, Standardwerkzeuge wie Beziehungen und Unterformular zu verwenden.
Sie können Webhook mit verwenden:

- Aktionsfeld;

- Modul für bedingte Aktionen.

Mal sehen, wie es funktioniert. Als Beispiel verwenden wir die Content Agency-Anwendung, die auf der Anwendungsseite installiert werden kann.

Außerdem werden wir den Dienst webhook.site für die Demonstration verwenden. Dies kann eine beliebige URL seinю

Kopieren Sie Ihre eindeutige URL. Öffnen wir nun das Artikelformular in unserer Content-Agentur-Anwendung.

Betrachten Sie die erste Möglichkeit – das Aktionsfeld:

Fügen Sie dem Formular das Feld "Aktion" hinzu (Sie finden es auf der Registerkarte "Zusätzlich");

 

2. Öffnen Sie die Seite zur Feldbearbeitung. Gehen Sie zur Registerkarte "Aufgaben" oder wählen Sie den Punkt "Was zu tun" aus;

3. Erstellen Sie eine neue Aufgabe. Wählen Sie den Webhook-Aufgabentyp aus;

4. Gehen Sie zum Abschnitt "Einstellungen".

Hier müssen Sie die URL einfügen (in diesem Beispiel ist dies die vom Dienst webhook.site empfangene URL).

Wählen Sie die Datenübertragungsmethode (GET, POST, PATCH, DELETE). Weitere Informationen zu Datenübertragungsmethoden finden Sie in der API-Dokumentation.

Wählen Sie den Inhaltstyp aus (multipart/form-data, application/x-www-form-urlencoded, application/json).

In diesem Beispiel verwenden wir die POST-Methode und den Typ „application/json“.

5. Im Abschnitt "Anforderungskopfzeilen" können Sie eine Kopfzeile und Daten für die Autorisierung hinzufügen (optional);

6. Im Abschnitt "Parameter anfordern" müssen Sie den Namen des Parameters angeben und Felder aus dem Formular auswählen:

Sie können auch Benutzerdefiniert aus der Liste auswählen. Daher übergeben Sie anstelle eines Werts aus dem Formular einen einzelnen Parameter.

Bitte beachten Sie: Um den Eigentümer des aktuellen Beitrags zu übergeben, müssen Sie einen benutzerdefinierten Parameter "copy_owners" mit einem beliebigen Wert, zum Beispiel "1", im Abschnitt "Parameter anfordern" hinzufügen:

7. Klicken Sie auf die Schaltfläche "Erstellen".

8. Klicken Sie zum Testen auf "Aktion" in der Tabelle:

9. Überprüfen Sie das Ergebnis der Datenübertragung im Webhook-Dienst:

Alle Daten wurden erfolgreich übertragen.

Sehen wir uns nun eine andere Methode des Moduls für bedingte Aktionen an.

Wir werden das gleiche Formular verwenden.

1. Gehen Sie zum Form Builder und öffnen Sie die Registerkarte Aktionen. Erstellen Sie eine neue bedingte Aktion.

2. Wählen Sie ein Kriterium zum Ausführen der Aktion aus (z. B. ist das Feld "Titel" nicht leer).

• Geben Sie den Namen und den Zeitpunkt der Durchführung der Aktion an (Formular gesendet, Datensatz aktualisiert, Zahlung abgeschlossen oder alle gleichzeitig).
• Wählen Sie die Webhook-Aktion aus.

3. Klicken Sie nach dem Erstellen der Aktion auf die Schaltfläche "Bearbeiten":

4. Sie müssen den Webhook genauso konfigurieren wie die Einstellungen im Feld Aktion. Klicken Sie neben der Aktion "Webhook"auf die Schaltfläche "Bearbeiten".

Bitte beachten Sie: Sie verwenden jedes Mal, wenn Sie Daten übertragen, einen API-Aufruf von Ihren Kontoressourcen.